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SECnONI 
OVERVIEW OF L/F-Unk MANUAL 



The sections in this manual are an-anged in the order that they should be read Section 2 
provides an introduction to L/F-Unk that will give an overview of tiie system and how it relates 
to TurboDOS and MS-DOS Section 3 explains the various technical aspects of the system 
Section 4 describes the actual installation procedure including all TurboDOS preparations and 
recommendations. Section 5 Is a qiick instaliation and boot guide. 

In using this manual, we assume that you have a copy of TurboDOS 14 or 14+ and that it has 
already been installed on your systera Further, we assume that you know how to use 
TurboDOS and MS-DOS or have access to the respective operating system user and 
programmer guides. Therefore, we have rK>t repeated any of the TurboDOS or MS-DOS 
instructions. 



SECTION 2 
INTRODUCTION TO L/F-Link 



2.1 WhatisTurboDC^? 

TurboDOS fe a disk operating system that enables the user to create and keep track of files, 
nn and link programs and access peripheral devfces that are attached to the computer. It is 
most distinguished by its ability to coordinate a "network' of interconnected 'slave" cards each 
with its own processor, memory and serial 1/0. 



2.2 What is MS-DOS? 

MS-DOS is a dfek operating system that also enables the user to create and keep track of files, 
run and link proc^ams and access [[^ri^hera! d^/ces that are attached to the computer. It is a 
single-user operating system 



2.3 What is L/F-Link? 

L/F-Link is an interface program between MS-DOS and TurboDOS. It enables MS-DOS 2.X 
software to operate under the supervision of TurboDpS on the 80186 16 bit slave processor. It 
is not an emulator, but MS-DOS Itself. L/FLink, together with the MS-DOS kernel 
(MSDOSSYS), is resident in the 'transient program area' (TPA) as a normal TurboDOS 
appik^atioa 



2.4 How does L/F-Link relate to TurboDOS and MS-DOS? 

TurboDOS is the primary operating system With L/F-Link, TurboDOS and MS-DOS 
applfcations can be run simultaneously, although each operating system has its own directory. 
since TurboDOS and MS-DOS kernels are operating slrnultaneously, each togical disk running 
MS-DOS applicatbns has dual directories: the normal TurboDOS directory and the MS-DOS 
directory (MSDIR, the root directory, and MSFAT, the file allocation table). 

When L/F-Link Is baded, MSDOSSYS is also toaded with the appropriate MS-DOS files. 
MS-DOS application programs can now be loaded and, upon completion of the L/F-LInk 
installation, will run on the MS-DOS operating system just as any application would be run on a 
single-user MS-DOS system Whenever the application requests a service from MS-DOS, the 
request Is intercepted by L/F-Link and translated Into a sequence of TurboDOS system calls 
that allows MS-DOS to execute the request. 

Since L/F-Link allows MS-DOS to act as a multiuser system (more than one user running 
single-user software), there are certah commands and files that MS-DOS will use in the 
single-user environment that will be taken over by TurboDOS This Is why some of the files, 
normally on the1\/1S-D0S system diskette, are not found in your directory. These commands 



are replaced by similar TurboDOS commands. Print spooling and disk format are examples of 
funcfions ttet TurboDOS performs. 



2J What are the advantages of L/F-Link? 

UtRJnk has been developed to allow businesses the capability of running applications under 
the TurboDOS arxl MS-DOS operating systems concurrently. L/F-Link was written to 
overcome the shgle-user Bmitations of MSOOS by enabling it to take advantage of the 
mJtiuser environrnent of the TurboDOS utilities. 



2.6 Who chooses L/F-Link? 

There are two situations where the choice of L/FLink is indicated Frst, it will be welcomed by 
the business person who already has an investment in MS-DOS programs and files. The 
installation of an L/F Technotogles system can provkJe multiple users with the ability to share a 
large library of business software as well as data files and expensive peripherals. At the same 
time, the investment in MS-DOS programSs files and data entry tsne is preserved. 

In the second instance, L/F-Link win be useful to the business person who needs multi-user 
(more than one user accessing single-user software) capabilities but also needs to run a 
specific application that is available only for MS-DOS The L/F Technologies system and 
TurboDOS supply the multi-user capabilities; L/F-Link provkJes the MS-DOS environment. 

L/F-Link, used with TurboDOSb may be the answer to the expansion needs of a business 
currently using single-user MS-DOS applfcations, or it may be the answer to one installing a 
multi-user system where a spedffc a|3|Dlfcation runs only under MS-DOS Used with an L/F 
Technotogles system, L/F-Link provktes a bridge to the more powerful worid of corporate 
computing offered by multi-user networking TurboDOS 



SECTIONS 
TECHNICAL ASPECTS OF L/F-Unk 



This sectfon will describe system requirements arxJ limitations of L/F-Link. It is intended for the 
technical person who understands Turtx)DOS and MS-DOSl It Is primarily a list of conditions 
that should be understood before fhalizing disk partitions and other TurboGEN proceckres. 
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L/RJnk will run under any TurboDOS implementlon (version 14 or better) with 256K. Most 
MS-DOS 2X software will run under L/F-Link. An L/F Technotogies' 16 bit slave processor with 
either an 8 bit or 16 bit master is required L/F-Link must be run on the slave processor not the 
rnasier> 



3.2 Limitations of L/F-Link 

L/F-Unk 

L/F-Link will not run PC-DOS applicatfons that require IBM machine-specific ROM-BIOS calls or 
bit-mapped grapNcs. The 1240 board FK)M will trap an IBM ROM-BIOS call, display the 
message 'unsupported hten-upt number 'rf detected", and return the user to the cun-ent 
process. However, the user shouW discontinue the use of that partcular applicatioa (The 1081 
board will not trap these ROM-BIOS calls; it will most likely reset the slave without saving any 
data) 

L/F-Link supports true multi-user file access under MS-DOS Files are always opened in a 
shared mode. Record bcking can be performed under L/F-Link by calling the corresponding 
TurboDOS system functions from the MS-DOS applicatioa All MS-DOS applications have 
access to all TurboDOS system functions by issuing the corresponding interrupt. As in 
TurboDOS, record locking must be implemented in the software application. 

The 'files=" parameter in the CONFiaSYS file, which detemiines the maximum number of files 
that can be opened simultaneously, cannot exceed 15 under L/F-Link. This is the default value 
setbyL/FiJnk. 

The performance of normal MS-DOS applications should not noticeably change when 
operating under L/F-Unk. However, MS-DOS programs that write to a disk file using many 
system <;alls to write only a few bytes each (as MS-DOS permits) should be avoided as much 
as possible. They usually cause substantial speed deterioration due to excessive system 
overiiead. TNs is the case with redirection of console output to a file: the COMMANDDIR file, 
for example, can be quite slow if the directory contains many entries. 



MS4X)8 

Lc^oal cfisk see is limited lay MS-DOS convention; the largest disk size processable by L/F-Unk 
and l^^&DOS is sTightly less than 10^ witfi a 4K aHocation bkx^. The physical sector size is 
%iited to K wNch is the defsuit MS-DOS buff er siza 

The number of buffers is not fmited — 20 will greatly improve performance if there is enough 
memory. MS-DOS buffer size always defaults to K whfch is the largest physical sector size 
recognized by the system. If a floppy driver recognizes different formats, the corresponding 
drive must contain a diskette vinth the largest sector size at L/HJnk boot time, so the correct 
birffer size fe selected L/F-Link also automatically determines the physteal memory size, so 
that MS4X)S always uses all available memory, regardless of TurboDOS configuratioa 

Interrupts 2Qki-27H are used by MS-D^ and cannot be used by TurlDoDOS for any other 
purpose. 

All TurboDOS files having reserved MS-DOS filenames should be renamed prior to L/F-Link 
arxJ SETMS executioa (A list of these names is included in the installation guide, section 4.3.) 

As in TurboDOS, disks can be changed only if all users on that disk are kJle, that is, ail files have 
been ctosed and all buffers flushed. When running MS-DOS under L/F-Link, all users on that 
disk should terminate applfcations and return to the MS-DOS prompt if they are using the 
disk(s) being changed Once the disk is kJle, the system manager should run the 
MOIANGEEXE utility supplied with L/F-Link. TNs works exactly like the TurboDOS CHANGE 
utility. 



TurboDOS 

Never use the same filename in different sub-directories unless they are in different user 
rumbers. This is a TurboDOS restrictioa 

Drives shoukl be assigned to users and users should be inNt>ited from use of other drives 
through SOiDRV or wNie TurboGENing the system. 

In order for the user to be altowed to run L/F-Link, the user must be a privileged user in 
TurixjDOS This must be defined in USERID.SYS when configuring the system. 



Hardware Limitations 

The ^EADPC conmsuxi on the 8 bit mast^ processors 280A or Z80B, under TurboDOS 14 
or 14+, with the 1081 S-KX) (non-plus) bis 16 bit slave, will only read IBM IX floppy disk format 
(5 1/4' shgie-sided, S sectors/track). READPC cannot be mn from the 8 bit master, It must be 
run from the 16 bit slave. 

The READPC command on the 16 bit master processor, 80186, under Turtx)DOS 14 or 14+, 
with the 16 bit 1081 S-100 (non-pliB) bus slave or the 1240 16 bit S-100+ (plus) bus slave, will 
read IBM IX and 2.X format (5 1/4' single or double-skJed, 8 or 9 sectors/track). READPC 
cannot be nn from the 16 bit slave when a 16 bit master Is present, it must t>e run from the 16 bit 
master. 

Tne 1081 board ROM will not trap the IBM FK)M-BIC^ calls. If an illegal call is made, the 
processor will reset. The 1240 board ROM will trap these calls and generate an error 
message. 

L/F-Link cannot be mn on the master. 



Rare Limitations 

A special case of MS-DOS system function 28H random bfock write is not supported by 
L/RJnk: if CX=0, no records are written, but the file size is adjusted TWs adjustment can be 
performed by TurtxDOS only if it does not alter the disk allocatioa In any other case, L/F-LInk 
will display 'adjust" and MS-DOS will report an error. 

Another unsupported, but rare, case is the creatkxi of a user number sub-directory from 
another user number sub-directory, using the command MKDIR A(user-no). It is, however, 
always possible to retum to the root drectory and create the new subdirectory from there. 



3.4 Other technical conditions 

When CTeating a new MS-DOS directory, SETMS automatically assigns TurboDOS files in 
non-zero user nunt>ers to pre-defined MS-DOS sub-directories, named 12„.31 according to 
the corresponding user nurnbers. They can also be created by MS-DOS (MKDIR), but only as 
direct cNldren of the root directory. Any file or other sub-directory that belongs to the path of a 
user number (to any depth) is automatically created in the corresponding user number. All 
other files and sub-directories default to user 0. 



3.5 Special Conditions 

L/F-Unk is not aware of disk allocation alterations made by TurboDOS users because 
they are not reflected in MSDIR and MSFAT. Should this happen by accident, all L/F-Link 
users should logoff as soon as possible. SETMS should then be run under TurboDOS to 
restore the directory compatibility. (All MS-DOS time stamps will be lost, as well as any 
sub-directories below the user level number.) 



AB liS-DOS floppies must be write-pratected A^-DOS floppy diskettes will be used only 
during the L/Rink nstaliation procedure. The TurfooDOS command "RE ADPC" is the only 

command, such as "DilT or ^DOPY", can be performed on an MS-DOS floppy. These 
commends will coraipt the ^-DQS floppy. 



SECTION 4 
INSTALLATION PROCEDURE 



This section will describe the TurboDOS preparations and recommendations that will allow 
more efficient use of TurboDC^ and MS-DOa 

Thfe section also provkJes a 5 step process for the installation of L/F-Lrrf< and the subsequent 
boot process that enables the user to access MS-DOS. The installation should not be done 
until a technical person has read section 3 and understands the limitations. 



4.1 TurboDOS preparations 

MS-DOS requires a special directory structure that must be created on all disks drives that 
MS-DOS will run on before rumsxj L/F4Jnk. 

A special utility, SETMS.CMD, is provided for the purpose of creating these directories. This 
utility is run while the user is still in TurboDOS and works just like the TurboDOS CHANGE 
utility. SETMS automatically sets the date and time stamps for any NEW files it encounters. It 
always starrps the MS-DOS disk label to reflect the last time SETMS was run on that disk. If an 
MS-DOS directory (MSDIR. MSFAT and possible sub-directory files) already exists on any 
reference disk, it is checked for compatibility with the TurboDOS directory. If any difference is 
found, the MS-DOS directory is updated to reflect the exact status of the TurboDOS directory. 
SETMS. like TurboDOS RXMAP and FORMAT utilities, attempts to took the drive before 
processing it. SETMS, therefore, requires that no process access the drive wNle SETMS is 
operating. 

MS-DOS requires the files MSDIR and MSf AT in order to run. Since MS-DOS is not aware of 
any disk albcation changes that take place in the TurboDOS directory, MSDIR and MSFAT 
shouki be assigned to a specific drive (not to exceed 16Mb) where only MS-DOS will be used. 
ShoukI MSDIR be deleted, it is re-created by SETMS, but the MS-DOS sub-directory structure 
is bst during tNs process, except for user number sub-directories. 

The files LFIJNK.CMD, MSDOSSYS and C0MMAND.COM must be present on the system; the 
latter two must reside on the same drive. Any required MS-DOS application or utility should 
also be copied so it can later be accessed by MS-DOS THIS MUST BE DONE WITH THE 
TurboDOS COPY UTILITY BEFORE THE INSTALLATION PROCEDURE. 

Data printed by an MS-DOS application will be routed to a printer with or without spooling, 
according to the current TurboDOS configuration. Spooling, however, is an independent 
TurboDOS process and alters the disk allocation map. Therefore, if print spooling occurred in 
the MS-DOS directory, L/F-Link would not be aware of the allocation changes caused by the 
spool files. TNs is solved by using a pure TurboDOS disk (without MSDIR and MSFAT) as the 
spool disk. 



42, Recommendations 

In a mtitKser ^stem, TurboDOS and MS-DOS software must be located on different tagicai 
drives. When someone is amlng software on the MS-DCS drive, no one using TurboDOS 
should aocess that driva All MS-DOS files must be kx-ated on the same disk partition to avoid 
any directory nrisallocations. 

It is recommerxJed that two different user Id and passwords be assigned to users wiio will t>e 
accessing both MS-DOS and Turix)DOS and that the user be forced to fogof f MS-DOS and tog 
back onto TurboDOS with a different kl This can be accomplished if USERID.SYS is defined as 
foQows: 

USERID^ASSWORD,0P^^[NK\DATE\LOGOFF. 



When the user togs on with user id and password, the system will automatfcally place the user 
on the "d" or MS-DOS drive and run L/F-Unk. When the user uses the attention-abort 
sequence (shift-control @, control c) to exit MS-DOS, the system will ask "return to 
Turix>D^S?*. When the user responds Y(es), the TurboDOS system tog on will appear "Enter 
user kt". The user shouW then be instructed to enter his/her TurboDOS togon wNch will place 
the user on a different drive. This process altows the users to be consckxis of being in 
TurboDOS and reduces the chance of making changes to the MS-DOS directory while other 
users are mnning MS-DOS applfcatfons. It also reduces the chance of an MS-DOS user 
executing a TurboDOS command wNle in MS-DOS whtoh is likely to reset the tocal processor. 

If the system manager wouki like an MS-DOS user to be togged onto the applteation that 
he/she will use automattoally, this functton can be added to the AUTOEXECBAT file in 
MS-DOS 

If the user chooses to use more than one disk partitton for MS-DOS, L/F-Link will load all disks 
when anyone on the system types L/F-Unk at the TurboDOS prompt 

It is recommended that the user run PROMPT $p$g so the current path will appear in the 
MS-DOS system prompt. PATH \ shoukJ be mn also to access utilities in the root directory from 
any other d'rectory. If no AUTOEXECBAT file exists when SETMS fe rua it is automatically 
created with the commands: PATH \ and PROMPT $p$g. 



4.3 Installing L/F-Link and MS-DOS 

After togging onto your L/F Technologies - TurboDOS computer, follow the steps below. Do 
not attenpt to do step 5 before completing steps 1 - 4. 



STEP t Determine wNch disk the MS-DOS files will be toaded oa It is recommended that all 
MS-DOS files be loaded on the same disk. 



STEP 2: Copy files from floppy to disk drive "d" or whichever drive has been selected for 
MSC)Oa (If ffcSpi:^ is ari IBM PC-DOS disk, use the READPC comn^^ 



STEP ^ List ditBGtory 'if to be Gertean that the r^cessa'y files are present. LRJNK.CMD, 
MSO^^YS, O0MMAND.^)M and all h^-DOS software application program files must be 
pr^ent All comrrxxi programs shouW be kxiatedon user area '0' 



STEP 4: Search all user areas of MS4X)S disk "d" and all user areas on the system boot disk 
for files named CON, PRN, AUX NUL COMt COM2, LPTt I-PT2, LPT3. Any TurboDOS file 
having any of these names (with any extension) must be renamed Failure to do tKs will cause 
disk alk)cation incompatibilities between TurboDOS and MS-DOS (If you have elected not to 

fiekfitnafa tyna Htcl^ rksarHtw-tn tn MQ-PW^Q fil^e o oAor/4^ r^ all #li»lr* an^ •■a^x *^m^»^t^ ...^. .m ^'^' -> 

to be done.) 



STEP 5: When this Is completed, type SETMS d at the TurboDOS operating system prompt 
(d^Jrive name). If th^e is more tiian one dsk reserved for MS-DOS^ type SETMS without 
designating the drive name and the system will request the drive(s) to set. 

The SETMS utility wilt 

• create MS-DOS directory files on the designated disk or disks. 

♦ automatfcally set file attributes MSDIR, MSFAT and MSDOS.SYS Ndden 
under MS^X>a 

. set MSDIR, MSFAT. MSDOaSYS, C0MMAND.COM, AUTOEXECBAT and 
any user number sub-directory to gtobal under TurboDOS. 

« set LFLINK.SYS and C0MMAND.COM to 'read-only' under TurboDOS to 
prevent acdderrtal deletion. 

« recreate MSDIR and MSFAT 

« create MS-DOS sub-directories under user area 0: 

« not delete sub-directories from other user areas. 

4.4 Booting MS-DOS 

After SETMS has been mn successfully and you are sure that TurboDOS and MS-DOS 
directories are compatible, type LFUNK at the Turix)DOS system prompt. The system will 
scan all directories until it finds a valkJ copy of MSDOaSYS (the MS-DOS kernel); it then loads 
it and executes all required initialization and linking code, then It loads COMMANDCMD (the 
MS-DOS console command processor) from the drive where MSDOSSYS was found If the 
system finds any directory inconsistency. It will display the message <DRIVE D ALLOCATION 
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MAP BAD - RUN SETMS>. After SETMS te run, the user should try to run L/F-Link again. If it 
still fafe, delete MSDIR and K^FAT, run FIXMAP and try agaia It should be successful. 
Ci'^i'nes "friat do not affect ^le biodc allocation are not diagnosed (renaming a file under 
Turtx)DOS). If h doubt SETMS should be rua 

TurixDDOS system prompt and only disk "d" wouW be searched for MSDOaSYS 

UF4Jnk automatically selects the cun-ent user-number subdrectory at boot time. This is 
performed by dynamfcally patching the AUTOEXECBAT file: a CD (user number) (or CD \ for 
user 0) command is inserted before its first line. The user can freely add or delete lines to the 
AUTOEXECBAT file, including the inserted CD command This line will be re-inserted or 
deleted at the next boot. 



4.5 L/F-Link SYSTEM OPERATION 

It is the user's responsibility to an SETMS before typing LFLINK if any MS-DOS file was 
altered under TurboD^ L/F-Unk does not check this and MS-DOS will not be aware of disk 
2tfkx5ation charts that may have occurred 

U(3on successful connpletfcn of L/F-Link, the MS-DOS system prompt appears ''d:\>' and any 
MS-DOS applicatkxi (EXE or .COM) can be ma 

All MS-DOS initialization features, such as. AUTOEXECBAT, CONFIG.SYS file and 
user-defffied drivers are fully supported 

MS-DOS users are immediately aware of any disk allocation or directory change performed by 
any of them Therefore, it is safe, from the operating system point-of-view, to run simultaneously 
any number of MS-DOS applfcations under L/F-Link. However, since MS-DOS uses internal 
buffering, it is possible that data, already read by an MS-DOS applicatloa can be altered by 
another user mnning the sartje ^Ipplfcation, without the first user being aware of this change. 
L/F-Link leaves it to the application devebper or the user to force the MS-DOS application to 
flush MS-DOS tMjffers and lock the con-esponding records. 
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SECTIONS 

QinCK L/F-Link INSTALL ATiON 

& 

MS4X>SB00T 



After logging onto your L/F Technok^s - TurboDOS computer, follow the steps below. 
Do not attempt to do step 5 before completr^ steps 1-4. 

MS-DC^ files t>e loaded on the same disk. 

STEP 2: Copy files from floppy to disk drive "d" or whichever drive has been selected for 
MS-DOa (Use READPC for IBM PC floppies.) 

STEP 3: List directory 'd* to be certain that the necessary files are present. LFLINK.CMD, 
MSDOaSYS, C0MMAND.COM and all MS-DOS software application program files must be 
present. All common programs should be located on user area '0': 

STEP 4: Search all user areas of MS^XB disk "d" and all user areas on the system boot disk 
for files named COti PRN, AUX, NUL COMt COM2. LPTt LPT2, LPT3. Any TurboDOS file 
having any of these names (with any extension) must be renamed Failure to do this will cause 
disk allocation incompatibilities betv^^een TurboDOS and MS-DOS (If you have elected not to 
dedicate one disk partition to MS-DOS files, a search of ail disks and user areas would have 
to be done.) 

STEP 5: When this is completed, type SETMS d at the TurboDOS operating system prompt 
(d=drive name). If there is more t\an one disk reserved for MS-DOS, type SETMS without 
designating the drive name and the system will request the drlve(s) to set. 

The SETMS utility will: 

« create MS-DOS directory files on the designated disk or disks. 
^ automatically set file attributes MSDIR, MSFAT and MSDOSSYS Ndden 
under MS-DOS 

« set MSDIR, MSFAT, MSDOSSYS COMMANDCOM, AUTOEXECBAT and 

any user number sub-directory to gtobal under TurboDOS 
^ set LFUNK.SYS and COMMAND-COM to read-only' under TurboDOS to 

prevent accidental deletkxi 
^ recreate MSDIR and MSFAT 
« create MS-DOS sub-directories under user area 0: 
• not delete sub-directories from other user areas. 
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STEP 6: Type LFLW^ 

«The welcome message appeals. 

WELCOMETa 

TFUnk" - MASHOV TURBODOS ENHANGEMEhJT 
MS^XS 2.0 IMPLEMEhTTATION UNDER TURBODOS 

(0) COPYRIGHT -©84 MASHOV SOFTWARE INDUSTRIES 

MEMORY SIZE = 04000H RARAGRAPHS, 3e35H FREE 
DRIVE D ALLOCATION MAP OK LOADING DiVISDOaSYSu. 
mzy-Lfuo version z.uu 
Copyright 1981,82,83 Microsoft Corp. 

LFLink RE V 109 (14 MAY 85) 
LOADING D:COMMAND.COM-. 
Command v. 2.02 

D>CD\ 

D>path\ 

D>prompt $p$g 

D:\> 
D:\> 

STEP 7: Return to TurboDOS - type BHIFTCONTJROL @, CJONTROL C. 

«The following appears on the screen. ^ 

Return to TurboDOS (Y/N): type N 

D\> 

Return to TurboDOS (Y/N>. type Y 

Date: 30 JU1 1985 Tuesday 
Time: 12:00:00 

System log on 
Enter user id: 
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SETMS UTILITY 



The process and computer m^sages lor the SETh^ utifity are bebw. 



OD]SETEdS 

TJTJrik" UTIUTY TO CREATEAFDATE MSDOS DIRECTORY & F^^ 
(0) Cof^nght 1984 Mashov Software Industries Ltd. 

Erterdrive(s)tosetforMS-DOS:type D 
DRlVED: 



LABEL N04J^BEL 

LOOKING FOR ACTIVE USER NUMBERS 

(IT THEN QUICKLY FLASHES ALL THE FILES AND UPDATES THEM.) 
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